home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Leser 15 / Amiga Plus Leser CD 15.iso / Tools / Development / MuRedox / MuRedox.readme < prev    next >
Text File  |  2002-03-12  |  6KB  |  149 lines
  1. Short:    MuLib based math speedup patch for 040/060
  2. Uploader: thor@math.tu-berlin.de (Thomas Richter)
  3. Author:   thor@math.tu-berlin.de (Thomas Richter)
  4. Type:     util/boot
  5. Requires: util/libs/MMULib.lha Kickstart V37, MuLib 68040/68060 lib
  6. Version:  40.4
  7.  
  8. ------------------------------------------------------------------------------
  9.  
  10. MuRedox is a MuLib based "on the fly" speedup patch for 68040
  11. and 68060 based Amiga boards. The 68040 and 68060 do not implement
  12. all instructions of the MC 68K family. The unimplemented instructions -
  13. mainly FPU instructions - generate an exception and need to be 
  14. emulated by the 68040 resp. 68060.library. This is the job of the so-
  15. called "FPSP routines" (floating point support package) within the
  16. CPU libraries. MuRedox detects these instructions as soon as they
  17. generate the emulator exceptions, runs a "just-in-time" compiler
  18. that generates a "stub replacement routine" for this specific
  19. instruction and patches the replacement routine into the running
  20. program. Hence, MuRedox replaces the overhead of the emulator
  21. trap on the next use of the same instruction sequence.
  22.  
  23. Therefore, MuRedox requires:
  24.  
  25. - At least an 68040 or an 68060. A 68030 or below implements all
  26.   instructions anyhow and does not require emulator traps at all.
  27.  
  28. - The mmu.library which is required to setup the special memory
  29.   mapping.
  30.  
  31. - The fpsp.resource. This resource contains the program code required
  32.   for most unimplemented math functions. This resource is made avail-
  33.   available by the mmu.library-based 68040 and 68060.library. 
  34.  
  35.   Therefore, installation of the "MuLib" libraries is *required*.
  36.   Please see the "MMULib.lha" package on Aminet how to install them.
  37.  
  38. ------------------------------------------------------------------------------
  39.  
  40. Top reasons why not to use this program:
  41.  
  42. - It is a hack. MuRedox replaces program code on the fly, hoping that all
  43.   will go well. This need not to be the case - especially commercial
  44.   programs may keep a checksum over their code and may fail if their
  45.   code gets altered. MuRedox will perform such code modifications.
  46.  
  47. - MuRedox will therefore not work for all programs - some 
  48.   incompatibilities should be expected.
  49.  
  50. If you need faster programs, you should rather:
  51.  
  52. - Ask the vendor for a 68060 or 68040 specific release of the program
  53.   that does not require the software emulated instructions of the 68040
  54.   resp. 68060. Typically, these versions will run faster than a 
  55.   68020/68030 version with MuRedox, anyhow.
  56.  
  57. - Remember: Programs are made fast by fast and smart algorithms, not by
  58.   your favourite speedup-patch. MuRedox will give some speed impact,
  59.   in realistic situations in the range of about 10%. Specific bench-
  60.   marks may show more dramatic improvements, but they typically test
  61.   situations that are untypical in a real-life situation. Motorola
  62.   choose less frequently used instructions for software emulation in
  63.   first place, hence improvements are typically marginal.
  64.  
  65. ------------------------------------------------------------------------------
  66.  
  67.                          The THOR-Software Licence (v2, 24th June 1998)
  68.  
  69.  
  70. This License applies to the computer programs known as "mmu.library", 
  71. "MuRedox", "FPSPSnoop" and the corresponding documentation, known as
  72. ".readme" files. The "Program", below, refers to such program. The "Archive"
  73. refers to the package of distribution, as prepared by the author of the
  74. Program, Thomas Richter. Each licensee is addressed as "you".
  75.  
  76.  
  77.  
  78. The Program and the data in the archive are freely distributable
  79. under the restrictions stated below, but are also Copyright (c)
  80. Thomas Richter.
  81.  
  82. Distribution of the Program, the Archive and the data in the Archive by a
  83. commercial organization without written permission from the author to any
  84. third party is prohibited if any payment is made in connection with such
  85. distribution, whether directly (as in payment for a copy of the Program) or
  86. indirectly (as in payment for some service related to the Program, or
  87. payment for some product or service that includes a copy of the Program
  88. "without charge"; these are only examples, and not an exhaustive enumeration
  89. of prohibited activities).
  90.  
  91.  
  92. However, the following methods of distribution
  93. involving payment shall not in and of themselves be a violation of this
  94. restriction:
  95.  
  96.  
  97. (i) Posting the Program on a public access information storage and
  98. retrieval service for which a fee is received for retrieving information
  99. (such as an on-line service), provided that the fee is not
  100. content-dependent (i.e., the fee would be the same for retrieving the same
  101. volume of information consisting of random data).
  102.  
  103.  
  104. (ii) Distributing the Program on a CD-ROM, provided that
  105.  
  106. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  107. especially this licence agreement;
  108.  
  109. b) the CD-ROM is made available to the public for a nominal fee only,
  110.  
  111. c) a copy of the CD is made available to the author for free except for
  112. shipment costs, and
  113.  
  114. d) provided further that all information on such CD-ROM is re-distributable
  115. for non-commercial purposes without charge.
  116.  
  117.  
  118. Redistribution of a modified version of the Archive, the Program or the
  119. contents of the Archive is prohibited in any way, by any organization,
  120. regardless whether commercial or non-commercial. Everything must be kept
  121. together, in original and unmodified form.
  122.  
  123.  
  124.  
  125.  
  126. Limitations.
  127.  
  128.  
  129. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  130. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  131. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  132. PARTICULAR PURPOSE AND NON-INFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  133. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  134. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  135. SERVICING, REPAIR OR CORRECTION.
  136.  
  137.  
  138. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  139. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  140. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  141.  
  142.  
  143.                                                         Thomas Richter
  144. ______________________________________________________________________________
  145.  
  146. So long,
  147.  
  148.     Thomas Richter (October 2001)
  149.